APPENDIX 

Imagein Device Manager 



The Imagein device manager provides interfaces for enumerating devices, querying properties of 
installed Imagein devices and creating Imagein device objects. The device manager has three 
objects. 

CImagelnDevMgr is used to: 

• Create an enumerator object, CEnumlmagelnDevInfo 

• Create a device object when given a DevicelD. 

• Display Ul to let a user choose a device object. 

• Display Ul to both choose a device and acquire an image from the chosen device. 
CEnumlmagelnDevInfo is used to: 

• Enumerate all Imagein devices on a system. For each device enumerated, a 
CImagelnDevInfo object is returned. 

CImagelnDevInfo is used to: 

• Query device information properties from the Imagein device. One of the properties, Device 
ID, can be used by CImagelnDevMgr to create a device object. 

Device information properties are distinct from normal device properties in that they are read from 

the registry and can be queried without forcing the device object to be created. 

A program using its own methods to select an Imagein device would do the following: 

• Create a CImagelnDevMgr object 

• Use the llmagelnDevMgr interface to create a CEnumlmagelnDevInfo object 

• Use lEnumlMAGEIN^DEVJNFO interface to create a CImagelnDevInfo object for each 
Imagein device enumerated. 

• Use IPropertyStorage interlace of CImagelnDevInfo object to inspect the device information 
properties of each device, save the Device ID property from the desired device. 

• Use the DevicelD property in llmagelnDevMgr interface to create an Imagein device object. 



llmagelnDevMgr Interface 

EnumlmageinDevlnfo 

:hresult llmagelnDevMgr: : EnumlmageinDevlnfo { 
LONG IFlags , 

IEnumIMAGEIN_DEy_INFO** ppIEnum) ; 

EnumlmageinDevlnfo creates a standard enumerator for CImagelnDevInfo objects. The 
enumerator itself is a CEnumlmagelnDevInfo object that has a single interface 
]EnumlMAGEIN_DEVJNFO. Applications can use this API to obtain device information properties 
from available Imagein devices. 

Parameters: 

IFlags Specifies the type of device to enumerate. 

ppIEnum Enumeration interface for CEnumlmagelnDevInfo objects. 
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GetlmagelnDevlnfo 

HRESULT I ImagelnDevMgr : : GetlmagelnDevlnfo ( 

SSTR bstrDevicelD, 
IPropertyStorage** ppIPropStg) ; 

Given a device ID GetlmagelnDevlnfo returns an IPropertyStorage interface to CImagelnDevlnfo 
objects. This API gives applications a quick way to retrieve device information properties from a 
stored device ID. 

Parameters: 

bstrDevicelD, Device ID string retumed from device info object 

pplPropStg IPropertyStorage interface to CImagelnDevlnfo objects. 



CreatelmagelnDev 

HRESULT I Image InDe vMgr : : Create Image InDev ( 

BSTR bstrDevicelD, 
lUnknown* * ppDevice) ; 

CreatelmagelnDev creates a device object identified by bstrDevicelD and retums an lUnknown 
interface to the object. The application can use Querylnterface on this lUnknown to access the 
other interfaces on a device. 

Parameters: 

bstrDevicelD Device ID string returned from device info object 

ppDevice lUnknown interface pointer returned. 



SelectimagelnDev 

HRESULT IlmagelnDevMgr : : SelectimagelnDev ( 
LONG IFlags, 
lUnknown** ppDevice) ; 

SelectimagelnDev displays Ul for the selection of Imagein devices. When the user selects a 
device, the device object is created and an lUnknown interface is retumed. The application can 
then use Querylnterface on this lUnknown to access the other interfaces on a device. Retums 
S^FALSE if the user cancels the selection dialog without making a device selection, S_OK if 
the user makes a device selection or an error value if the method feiis. 

Parameters: 

■Flags Operation flags 

ppDevice lUnknown interface pointer returned 
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Getlmage 

13RESULT I Image InDevMgr : : Get Image { 

LONG iFlags, 
LONG llnteixt, 
LONG cf Format, 

STGMEDIUM* pMedium) ; 

Getlmage displays device selection Ul allowing a user to select a device. If the user selects a 
device, a device is created and device Ul is displayed to capture the image. Image data is 
returned in the pMedium structure. Image format and default image capture properties may be 
specified using the llntent and cfFormat parameters. Returns S^FALSE if the user cancels the 
selection dialog without making a device selection. S_OK if the user makes a device selection and 
the data is transfen-ed or an en-or value if the method feils. 



Parameters: 

•Flags Operation flags 

"ntent Intent, default image capture properties 

CfFormat Clipboard format desired by application 

pMedium Image is returned through this medium. 



EnumDestinationlnfo 

IIRESULT I Image InDevMgr: : EnumDestinationlnfo ( 
^LONG iFlags, 
lUnknown* pDevice, 
IEnumIMAGEIN__DEST_INFO** ppIEnum) ; 

EinumlmagelnDestlnfo creates a standard enumerator for CImagelnDestlnfo objects. The 
enumerator itself is a CEnumlmagelnDestlnfo object that has a single interface 
lEnumlMAGEIN^DESTJNFO. Applications can use this API to obtain device destination 
properties from an Imagein device. Destination applications are registered using 
RegisterDestinationApplication. 

F*arameters: 

IFlags Enumeration flags. 

pDevice Device object. If null destination applications for all devices are 

enumerated. 

pplEnum Enumeration interface for CEnumlmagelnDestlnfo objects. 



FiegisterDestinationAppiication 

BI^SULT IlmagelnDevMgr: : RegisterDestinationApplication ( 
LONG IFlags, 
LONG llntent, 
lUnknown* pDevice , 

SSTR bstrEvent, 
SSTR bs t r AppName , 

^S"^^ bstrCommandLine) ; 

This method is called when an application wishes to register as an Imagein destination. 
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Parameters: 



IFlags 
Untent 
pDevice 

bstrEvent 
bstrAppName 

bstrCommandLine 



Registration flags. 

Intent, default image capture properties. 

Device object. If null, destination application is registered for all 

devices. 

Optional event name. 

Friendly name of Application. This name will be displayed to the user 
inUI. 

Full path to the executable for this application. Additional command 
line arguments may be added to this command. 



UnregisterDestinationApplication 

HRESTUL IlmagelnDevMgr: :UnregisterDestinationApplication 
LONG iFlags, 
lUnknown* pDevice, 
BSTR bstrAppName) ; 

This method is called when an application that has registered an Imagein destination wishes to be 
uninstalled or no longer known as an Imagein destination 

Parameters: 

IFlags Operation flags. 

pDevice Device object. If null, destination application is unregistered for all 

devices. 

bstrAppName Friendly name of Application, used to register application. 



IEnumlMAGEIN_DEVJNFO Interface 

The lEnumlMAGEIN^DEVJNFO Interface is a standard OLE enumeration interface that supports 
per device enumeration of device information properties. 

Next 

HRESULT IEnumIMAGEIN_DEV_INFO: :Next( 
ULONG celt, 
IPropertyStorage** rgel t , 
ULONG *pceltFetched) ; 

Next returns an array of IPropertyStorage interfaces to CImagelnDevInfo objects. Applications 
can use the returned of IPropertyStorage interfaces to obtain device information properties from 
available imagein devices. 

Parameters: 

Specifies the number of elements requested. 
''9^1^ Address of an array in which to return the IPropertyStorage interfaces. 

pceltFetched Address of a value that receives a count of the item identifiers actually 

returned in rgelt. 
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Skip 

HRESULT IEnumIMAGEINJDEV_INFO: :Skip(ULONG celt); 

Skip skips device objects in the enumeration. 

Parameters: 

celt Number of items to skip. 

Reset 

HRESULT lEnumlMAGEINJDEV^INFO : :Reset (void) ; 

Reset sets the enumeration back to the first device. 
Clone 

HRESULT IEnumIMAGEIN_DEV_INFO: : Clone { 

IEnumIMAGEIN_DEV_INFO **ppIEnum) ; 

Clone creates another lEnumliWAGEIN^DEVJNFO enumeration object and returns an interface 
pointer to it. 

F'arameters: 

ppIEiram Address that receives a pointer to the new enumeration object. 

lEnumlMAGEIN.DESTJNFO Interface 

The IEnuml!\/1AGEIN_DESTJNF0 interface is a standard OLE enumeration interface that 
supports enumeration of device destination properties. 

Next 

EERESULT IEnumIMAGEIN_DEST_INFO : :Next ( 
ULONG celt, 
IPropertyStorage** rgelt, 
OTiONG *pceltFetched) ; 

Next returns an array of IPropertyStorage interfaces to CImagelnDestlnfo objects. Applications 
can use the returned of IPropertyStorage interfaces to obtain destination infomnation properties 
fi*om available Imagein devices. 

Parameters: 

celt Specifies the number of elements requested, 

rgelt Address of an array in which to return the IPropertyStorage interfaces. 

pceltFetched Address of a value that receives a count of the item identifiers actually 
returned in rgelt 

Skip 

HRESULT IEnumIMAGEIN_DEST_INFO: : Skip (ULONG celt) ; 
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Skip skips destination objects In the enumeration. 



Parameters: 

celt Number of items to skip. 

Reset 

:HRESULT IEnumIMAGEIN_DEST__INFO: : Reset (void) ; 

Reset sets the enumeration back to the first device. 



Clone 

:EIRESULT IEnumIMAGEIN_DEST_INFO : : Clone { 

IEnuinIMAGEIN_DEST_INFO **ppIEnum) ; 

Clone creates another IEnumlMAGEIN_DESTJNFO enumeration object and returns an interface 
pointer to it. 

Parameters: 

ppBEnum Address that receives a pointer to the new enumeration object. 



IPropertyStorage Interface 

The IPropertyStorage interface is used to query the device information and destination properties, 
IPropertyStorage is a standard OLE interface and is documented in the OLE Programmers 
Reference. All device Information properties are read only. Any attempt to modify the device 
infonnation properties will result in a failure with access denied. The methods of this Interface are: 



:HRESULT ReadMultiple (ULONG, const PROPSPEC, PROPVARIANT) ; 

:aRESULT WriteMultiple (ULONG, const PROPSPEC, PROPVARIANT, PROPID) ; 

:E!RESULT Dele teMultiple (ULONG, const PROPS PEC ) ; 

:erESULT ReadPropertyNames (ULONG, const PROPID, LPOLESTR) ; 

iHRESULT WritePropertyNames (ULONG, const PROPID, LPOLESTR); 

iSRESULT DeletePropertyNames (ULONG, const PROPID) ; 

]3RESULT Commit (DWORD) ; 

JrlRESULT Revert (void) ; 

13RESULT Enum ( lEnumSTATPROPSTG* * ) ; 

IriRESULT SetTimes (FILETIME const *, FILETIME const *, FILETIME const *) ; 
]3RESULT SetClass (REFCLSID) ; 
laRESULT Stat (STATPROPSETSTG *) ; 



Device Information Properties 

M Imagein devices support the following basic device information properties: 

Device CLSID - The CLSID of the ImageIn server for this device. 

Unique Device ID - A device ID which is unique per physical device. 
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Vendor Description 
Device Description 
Device Type 
Device Port Name 
Device Friendly Name 
Device Icon Resource 
Device Bitmap Resource 
Server Name 



- The device manufactures name. 

- A description of the device. 

- A device type constant: scanner, camera... 

- Name of the port through which the device Is connected. 

- A user readable device name. 

- Resource file name and ID. 

- Resource file name and ID. 

- The name of the server where the Imagein server for this 
device is running. 
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Imagein Scanner Device Obj ect 

Imagein device objects support interfaces for querying and setting device properties, displaying 
device Ul and transferring data. Imagein devices are required to support a small number of 
standard interfaces that allow applications to deal with all devices in a common manner and 
transfer data from the devices in a manner that is native to the (COM) application. Device objects 
may also support more specialized interiaces to implement custom functions. Since the 
application has a direct connection to the device object, this architecture does not place any strict 
limits on the interfaces a device object can export. Practically speaking though, applications must 
know about an interface for it to be useful. 



IScan Interface 



ScanDIg 

HRESULT ScanDIg ( 

LONG iFlags, 
liONG llntent) ; 

ScanDIg presents the system or device Ul needed to prepare a device for scanning. If the dialog 
successfully completes, the scan object will be ready to begin data transfer via the IDataObject or 
limageTransfer interfaces. The default image capture properties may be specified using the 
optional llntent parameter. Returns S^FALSE if the user cancels the selection dialog without 
making a device selection, S_OK if the user makes a device selection or an enror value if the 
method fails. 

Parameters: 

'Flags Operation flags 

llnterit Intent, default image capture properties 



IPropertyStorage Interface 



The standard IPropertyStorage interface is used to query and set all scan device properties. 
IPropertyStorage is a standard OLE interface and is documented in the OLE Programmers 
Reference. The methods of this interface are: 

HRESULT ReadMultiple {ULONG, const PROPSPEC, PROPVARIANT) ; 

HRESULT WriteMultiple (ULONG, const PROPSPEC, PROPVARIANT, PROP ID ) ; 

HRESTOT DeleteMultiple (ULONG, const PROPSPEC) ; 

HRESULT ReadPropertyNames (ULONG, const PROPID, LPOLESTR) ; 

HRESULT WritePropertyNames (ULONG, const PROPID, LPOLESTR); 

HRESULT DeletePropertyNames {ULONG, const PROPID) ; 

HRESULT Commit (DWORD) ; 

HRESULT Revert (void) ; 

HRESULT Enum ( lEnumSTATPROPSTG* * ) ; 

HRESULT SetTimes (FILETIME const *, FILETIME const *, FILETIME const *) ; 
HRESULT SetClass (REFCLSID) ; 
HRESULT Stat (STATPROPSETSTG *) ; 

All Lnageln scanner devices support the following basic device properties: 
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Horizontal Resolution 
Vertical Resolution 
Horizontal Scan Start Position 
Vertical Scan Start Position 
Horizontal Scan Extent 
Vertical Scan Extent 
Scan Data Type 
Scan Color Depth 



- The horizontal resolution in DPI. 

- The vertical resolution in DPI, 

- The horizontal start position in pixels. 

- The vertical start position in pixels. 

- The width of the scan in pixels. 

- The height of the scan in pixels. 

- A data format specification constant 

- The number of bits per pixel used to specify color. 



Imagein scan devices may support additional device properties depending on hardware configuration. 



IDevPropStream Interface 

The IDevPropStream interface is used to query/set ail current device properties from/to a named, 
non-volatile, registry based storage. The methods of this interface are: 



ReadDevPropStream 

HRESULT ReadDevPropStream (BSTR bstrName) ; 

ReadDevPropStream reads a device property stream from the specified value and initializes the 
device with tiiese properties. The properties are per user and per device. 

Parameters: 

bstrName Name of the property stream. 



WriteDevPropStream 

HRESULT WriteDevPropStream (BSTR bstrName); 

WriteDevPropStream writes the cun-ent device property stream to the specified value. The 
properties are per user and per device. 

Parameters: 

bstrName Name of the property stream. 



ListDevPropStreams 

HRESULT ListDevPropStreams (BSTR *pbstrName) ; 

ListDevPropStreams lists the device property stream names present in non-volatile storage. The 
list is returned in an allocated BSTR which the application must free using SysFreeString. 

Parameters: 

pbstrName Pointer to receive a list property streams. 
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DeleteDevPropStream 

HRESULT DeleteDevPropStream {BSTR bstrName) ; 

DeleteDevPropStream deletes a device property stream from non-volatile storage. 
Parameters: 

bstrName Name of the property stream. 



IDataObject Interface 

The IDataObject interface is a standard OLE data transfer mechanism. This interface is used to provide an 
easy and natural way for applications to transfer data from a scan device. The full mataObject interface 
description can be found in the 0LE2 Programmer's Reference. The methods of this interface are: 

HRESULT GetData(LPFORMATETC, LPSTGMEDIUM) ; 

HRESULT GetDataHere(LPFORMATETC, LPSTGMEDIUM); 

HRESULT QueryGetData (LPFORMATETC) ; 

HRESULT GetCanonicalFormatEtc {LPFORMATETC , LPFORMATETC) ; 

HRESULT SetData (LPFORMATETC, STGMEDIUM FAR *, BOOL) ; 

HRESULT EnumFomatEtc (DWORD, LPENUMFORMATETC FAR *) ; 

HRESULT DAdvise(FORMATETC FAR *, DWORD, LPADVISESINK, DWORD FAR *) ; 

HRESULT DUnadvise (DWORD) ; 

HRESULT EnumDAdvise (LPENUMSTATDATA FAR *) ; 



llmageTransfer Interface 

The llmageTransfer is a high performance data transfer interface. This interface uses a shared memory 
window to transfer data from the device object to the application, eliminating unnecessary data copies 
during marshalling. For Simplicity, this interface uses the same fonnat negotiation method as IDataObject 
llmageTransfer uses two different mechanisms to transfer data.: 

Banded Transfers 

The device breaks a large image transfer up into smaller transfers, which are performed sequentially into an 
application-specified buffer. 

Data Callback 

The device does a single large transfer, while caUing back to the application as the transfer progresses. 
itAI locateTransferB uffer 

HRESULT itAllocateTransferBuffer { 
LONG iFlags, 
LONG iSize, 
ULONG hSection, 
ULONG ProcessID) ; 

Allocates a buffer to use for scamiing data from the device. The buffer is mapped into the address space of 
both the client and server process. 
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Parameters: 

IFIags Operation flags. 

ISize Size in bytes of the requested buffer. 

hSection Mapped section handle 

ProcessID Caller process ID 

itFreeTransferBuffer 

HRESULT itFreeTransferBuffer(void) ; 

Free the buffer created by itAllocateTransferBuffer. This buffer Is also freed when the device 
object is destroyed. 

itBeginTransfer 

HRESULT itBeginTransfer ( 

LPFORMATETC pFormatEtc , 

LONG iFlags, 

IDataCallback* pIDataCallback) ; 

Reset a device object context to begin an llmageTransfer. 

F^arameters: 

pFomnatEtc Fomiat specification. 

IFIags Operation flags. 

pIDataCallback Optional transfer progress notification entry point. 

itGetlmage 

HRESULT itGetlmage ( 

LONG IFIags, 

LONG* plSrcOffset, 

LONG* pcbWritten) ; 

Perfomn an image transfer. 

Parameters: 

IFIags Operation flags. 

pISrcOffset Source pointer for transfer. 

pcbWritten Actual number of bytes written during transfer. 

itGetimageCB 

HRESULT itGetimageCB (LONG iFlags) ; 

Perform an image transfer using a user specified callback. 

Parameters: 

IFIags Operation flags. 



itEndTransfer 

HRESULT itEndTransfer (LONG IFIags); 



Appendix Page 11 



Cleanup a device object context after an image transfer. 



Parameters: 

•Flags Operation flags. 

itQueryGetData 

HRESULT itQueryGetData (LPFORMATETC pf e) ; 

Check to see if a device si5)ports a given format in an image transfer. 

Parameters: 

Pfe Pointer to the FORMATETC structure defining the format. 

medium, and target device to use for the query. 

itEnumFormatEtc 

HRESULT itEnumFormatEtc ( 
DWORD 

LPENUMFORMATETC* 

Create a fonnat enumerator. 

Parameters: 

- dw Reserved 
IpEnum Indirect pointer to the lEnumFORMATETC interface on the 

enumerator object 



IpEnum) ; 
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Imagein Camera Device Object 

The Imagein Camera is a hierarchical object. The top-level camera object is used to get basic device 
information and also to get access to individual images or image folders. The CCameraltem object 
represents images and Image folders. 

■Camera Interface 

TakePicture 

HRESULT TakePicture ( ) ; 

The TakePicture method instructs a camera to take a new picture. 



GetCameraRootltem 

HRESULT GetCameraRootltem (ICameraltem** pICameraltem) ; 

This method returns an interface to the root CCameraltem object. Using the Icameraltem interface it is 
possible to enumerate all images on the camera. 

Parameters: 

PICameraltem Interface pointer to root camera item 

GetCameraltemByHandle 

HRESULT GetCameraltemByHandle ( 

ULONG ulItemHandle, 
ICameraltem** pICameraltem) ; 

This method returns an ICameraltem interface to the specified CCameraltem object A handle for a 
CCameraltem object can only be obtained through the ICameraltem interface. 

Parameters: 

ulItemHandle Handle to camera item, previously retumed by Cameraltem 

interface 

pICameraltem Interface pointer to Camera Item specified by handle 

CameraDlg 

HRESULT CameraDlg ( 

LONG IFlags, 

LONG llntent, 

ICameraltem** pICameraltem) ; 



Display the camera UI. UI will select an image on a device and prepare for image transfer. The UI returns a 
][CameraItem interface to a CCameraltem ready for data transfer. IDataObject or OmageTransfer interfaces 
are then used to transfer image data. 
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Parameters: 

IFlags Operational flags 

Untent High level intent 

plCameraltem Interface pointer to Camera Item selected by Dig 



ICameraltem Interface 

A CCameraltem object is created for every image and directory on the camera. This is done to support full 
and flexible hierarchical image storage on cameras. A ICameraltem pointer is retumed for each 
CCameraltem object ICameraltem methods are defined below. 

GetltemType 

HRESULT GetltemType (ULONG *pItemType) ; 

GetltemType returns die type of camera item the object represents. The two types of camera items are: 

1 . ItemTypeFolder - CCameraltem is a folder that may contain other CCameraltems 

2, ItemTypelmage - Ccameraltem is an image. 
Parameters: 

pItemType Item Type retumed 

GetitemHandle 

HRESULT GetitemHandle (ULONG *pItemHandle) ; 

Returns a handle to the CCameraltem. This handle can later be used by the ICamera interface to get an 
mterface pointer back to this object 

Parameters: 

PItemHandle Item handle returned. This handle may be used by the GetCameraltemByHandle 
method of the ICamera interfece to obtain an Icameraltem pointer. 

OpenlmagePropertyStorage 

HRESULT OpenlmagePropertyStorage (IPropertyStorage** 
ppIPropertyStorage) ; 

Returns an IPropertyStorage interface to the CCameraltem object. 

Parameters: 

ppIPropertyStorage Retumed IPropertyStorage interface pointer. 

EnumChilditems 

HRESULT EnumChilditems {lEnumCameraltem** ppIEnumCameraltem) ; 

Creates a CEnumCameraltem object and returns a lEnumCameraltem mterface to it This method only 
works if the camera item is a folder and die folder is not empty, as shown in the figure above. 



Appendix Page 14 



r 



Parameters: 

ppIEnumCameraltem Pointer to iEnmnCameraltem interface. 

lEnumCameraltem Interface 

lEnumCameraltem is a standard OLE enumerator interface with the usual four metiiods Next, Skip, Clone 
and Reset. This enumerator will return an ICameralnterface for each camera item in the cuirent camera 
folder (that was used in the call to EnumChildltems). 

Next 

HRESULT Next ( 

ULONG celt, 
ICameraltem** ppICameraltem, 
ULONG* pceltFetched) ; 

Retum an ICameraltem interfece for each CCameraltem contained by the cuirent folder. 
Parameters: 

celt number of camera items to get 

ppICameraltem List of iCameraltem interface pointers returned. 

pceltFetched Number of interface pointers returned 

Skip 

:HRESXJLT Skip (ULONG celt) ; 
Skip celt CCameraltem objects. 
Parameters: 

celt Number of Ccameraltem objects to skip 

Reset 

ISRESULT Reset (void) ; 
Begin at the first CCameraltem object 
IParameters: None 

Clone 

]?IRESULT Clone (lEnumCameraltem **ppIEnumCameraItem ) ; 
Create a new CEnumCameraltem object and retum a lEnumCameraltem interface. 
Parameters: 

ppIEnumCameraltem New enumerator created to exactly match this one. 
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Camera Download Manag er 



The camera download manager monitors the connection status of camera devices. When a camera device is 
connected to the system, the Download Manager will attempt to immediately download all the images from 
the camera onto the system hard disk. The camera download manager will also maintain a data base of all 
images previously downloaded from a given camera and not download images that are already cached. 

Caching images in this manner has several advantages. 

• Camera image download can be very slow, this cache prevents any image from needing to be 

downloaded more than once. 
« Applications do not need a special API to acquire images from a camera, simply wait for the download 

to con^lete and load the image from the fQe system. 
« Images are safely and automatically copied to the fUe system where they can easily be edited, 

archived, printed or just saved. 

In order for flie camera download manager to work effectively, camera events must be detectable. For 
example, it should be easy to detect when a camera is connected or disconnected from the system. This 
should be detectable widiout loading the entire camera driver. Also any activity performed directly on the 
cjamera (through camera controls) must be reported to software so an accurate internal model of the state of 
the camera can be kept. 
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Sample Code 

Get an image from an Imagein device. Use the Imagein device manager device selection UI and the device 
image acquisition UI. 

/***************************************************************** 
* 

* GetltnageFromlmageIn 
* 

* DESCRIPTION: 

* Use the Imagein device manager to select a device and acquire an 

* image using the device UI. 
* 

* PARAMETERS : 

* pszDIBfileName - Name of the DIB file which contain the image data. 
******************************************************************************* I 

HRESULT GetIraageFromImageln(LPOliESTR pszDIBfileName) 

HRESULT hr; 
IlmagelnDevMgr *pIImageInDevMgr; 

// Get Imagein device manager object, 
hr = CoCreateInstance(CLSID_ImageInDevMgr, 
NULL," 

CLSCTX_LOCAL_SERVER, . 

IID_IImageInDevMgr , 

(void* * ) &pl ImagelnDevMgr ) ; 

if (SUCCEEDED (hr)} { 
ST6MEDIUM StgMedium; 

// Fill in the storage medium spec and get the image. 
StgMedium. tyraed = TYMED_FILB; 
StgMedium. IpszFileName = pszDIBfileName; 
StgMedium. pUnkForRelease = NULL; 
hr = pIImageInDevMgr->GetImage(0, 

0, 

CF_DIB, 
&StgMedium) ; 

pi ImagelnDevMgr- >Release 0 ; 

} 

return hr; 
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Enumerate all installed Imageln devices and get the device ID of a specific device: 

/******** ******************************************************************^ 
* 

* GetDevicelDfroroDescription 
* 

* DESCRIPTION: 

* Get the unique device ID of an Imageln device based on it*s description. 
* 

* PARAMETERS: 

* pszDescription - Requested device description, from device info properties. 

* pszDevicelD - Buffer for the returned device ID, 

* cbDevicelDSize - Size of the returned device ID buffer in bytes. 
* 

*******************************************************************************/ 

HRESUliT GetDeviceIDfromDescription( 
I4POLESTR pszDescription, 
LPOIiESTR pszDevicelD, 
UINT cchDevicelD) 

{ 

HRESULT hr; 
IlmagelnDevMgr *pIImageInDevMgr; 

if (pszDevicelD && cchDevicelD) { 
*pszDeviceID - ' \0 * ; 

} 

else { 

return E_INVALIDARG; 

} 

// Get Imageln device manager object, 
hr CoCreateInstance(CLSID_ImageInDe'u^^gr, 
NULL, 

CLSCTX_LOCAL_SERVER, 
I ID_X Image InDevMgr , 
(void**) SpIImagelnDevMgr) ; 

if (SUCCEEDED (hr)) { 

IEnumIMAGEIN_DEV_INFO *pIEnumIMaGEIN_DEV_INFO; 
PROPSPEC PropSpec [13 ; 
PROPVARIANT PropVarDesc [1] , PropVarlDCU ; 
UINT cbSize; 

// Get an enumerator for the Imageln device information. 

hr = pIImageInDevMgr->EnumImageInDevInfo(0, &pIEnuraIMAGEIN_DEy_INFO) ; 

if (SUCCEEDED (hr)) { 

IPropertyStorage *pIPropStg; 

ULONG ul; 

// Enumerate the Imageln devices, getting a IlmagelnDevInfo 
// pointer for each. Use this interface to query the registry 
// based properties for each installed device, 
ul = 1; 

while ((hr = pIEnumIMAGEIN_DEV_INFO->Next (1, 

&pl Props tg, 
&ul)) S_OK) { 

// Read the device description for the current device. 
PropSpec [0] .ulKind = PRSPEC_PROPID; 
PropSpec [0] .propid = DIP_DEy_DBSC; 

hr = pIPropStg->ReadMultiple (1, PropSpec, PropVarDesc) ; 
if (SUCCEEDED (hr) ) { 

// Test for a description match. 

if ( iwcscmp (PropVarDesc [0] .pwszVal, pszDescription)) { 
// Read the device ID. 
PropSpec [0] .propid = DIP_DEV_ID; 

hr = plPropStg->ReadMultiple(l, PropSpec, PropVarlD) ; 
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if (SUCCEEDED (hr) ) { 

wcsncpy (pszDevicelD , PropVar ID [ 0 ] . pws zVal , cchDevicelD ) ; 
PropVariantClear(PropVarlD) ; 

} 

} 

PropVariantClear<PropVarDesc) ; 

} 

pIPropStg->Release() ; 
if {*pszDeviceID) { 
break; 

} 

} 

pIEnumIMRGEIN_DEV_INFO->Release() ; 

} 

plIraageInDevMgr->Release() ; 
if ( ! *pszDevicelD) { 
hr = E_FAIIi; 

} 

- } 

return hr; 
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